Ficha técnica

Idempotencia

Concepto y uso

La API de pagos y transferencias de BTG Pactual Empresas utiliza la idempotencia como forma de garantizar que puedas repetir una solicitud, en casos adversos como por ejemplo una pérdida de conexión, sin el riesgo de duplicar una operación.

Esto se hace por medio de un header x-idempotency-key.

• x-idempotency-key se utiliza para enviar la clave de idempotencia definida por el usuario. Acepta cualquier valor.

La clave presente en x-idempotency-key estará vinculada al operador que emitió el token. Así, operadores diferentes pueden usar la misma clave, siempre que estén usando tokens diferentes.

Recomendamos utilizar un uuid para cada solicitud que posteriormente será almacenado por ustedes para control. Así, en caso de que no haya respuesta de la API y se use el mismo uuid, la solicitud no será duplicada.

📘 Ejemplo

curl --location 'https://api.empresas.btgpactual.com/1111111111/banking/payments' \
--header 'Authorization: ••••••' \
--header 'x-idempotency-key: f08jjj6b-00bc-1e3e-ad99-acb353333914'
--data '{...}'

Si no se envía el x-idempotency-key, la API entenderá que no se desea utilizar la idempotencia y, por lo tanto, asumirá el comportamiento estándar.

Comportamiento

La idempotency-key quedará vinculada a una llamada que resultó en una respuesta de la API por 24 horas. Así, si otra llamada se realiza usando la misma idempotency-key, se retornará la respuesta de la primera. Por ejemplo:

Una llamada fue exitosa usando la x-idempotency-key "abcde" y tuvo como respuesta:

{
  "batchId": "b9123459b123-123pgsf",
  "contractGuid": "123434545gpa234",
  "operationNeedsApproval": "true"
}

Cualquier solicitud subsiguiente que utilice "abcde" como idempotency-key dentro de 24 horas no será ejecutada en el sistema, con el fin de prevenir duplicidad y el retorno será:

{
  "batchId": "b9123459b123-123pgsf",
  "contractGuid": "123434545gpa234",
  "operationNeedsApproval": "true"
}

Este comportamiento es independiente de lo que se envíe en el body de la solicitud; si la x-idempotency-key es la misma, dentro de 24 horas, la respuesta será la misma.

Alcances necesarios

El token para consumir la API de Pagos debe ser generado usando el Authorization Code.

El alcance openid es obligatorio. Permite consultar el perfil del usuario BTG con acceso a la cuenta.

Es necesario elegir uno de los siguientes alcances:

Alcance	Descripción
brn:btg:empresas:banking:payments	Permite crear y consultar pagos.

Estados de pagos y máquina de estados

Un pago puede tener diversos estados.

Estado	Descripción
CREATED	Pago en línea en procesamiento.
CONFIRMED	Pago confirmado
REVERTED	Pago revertido
FAILED	Fallo en el pago
SCHEDULED	Pago programado
ADJOURNED	Pago en reintento, será reprocesado por el sistema
PROCESSED	Pago procesado
CANCELED	Pago cancelado

Los estados CANCELED, FAILED y REVERTED no pueden ser revertidos. Al recibir estos estados, un pago es cerrado.

El estado CONFIRMED indica que hubo débito en la cuenta de origen, pero puede ser revertido:

Eventos de webhook

La propiedad "detail" tomará el formato referente a su "type". Consulte la API Reference de Crear iniciación de pago o transferencia

Eventos posibles

Eventos	Descripción
payments.confirmed	Pago confirmado
payments.retained	Pago retenido en la capa de fraudes
payments.created	Pago creado
payments.canceled	Pago cancelado
payments.failed	Fallo en el pago
payments.processed	Pago procesado
payments.adjourned	Pago aplazado
payments.reverted	Pago revertido
payments.scheduled	Pago programado
payments.validated	Pago validado
payments.invalidated	Pago invalidado

Los payloads disponibles a continuación representan el contenido del campo data.

payments.validated

{
    "paymentId": "b96e54b3-da05-46e8-9845-99ec1e57339b",
    "type": "PIX_KEY",
    "amount": 350,
    "batchId": "437a4198-f14f-4bb6-b1e7-e1a68243bae9",
    "scheduledDate": "2025-04-07",
    "paymentDate": "2025-04-07",
    "status": "VALIDATED",
    "debitParty": {
        "taxId": "33330336000333",
        "name": "FANTASY NAME",
        "number": "003333351",
        "branchCode": "50",
        "bankCode": "208"
    },
    "detail": {
        "key": {
            "value": "50833333000333",
            "type": "TAX_ID"
        },
        "endToEndId": "E303333942023330719104edc4bd4444",
        "creditParty": {
            "account": {
                "taxId": "***588720001**",
                "name": "Nome"
            }
        }
    },
    "tags": {
        "externalId": "05f0333b-c539-4333-8bf3-dcb3a333ecb5"
    }
}

payments.retained

{
	"paymentId": "a719482a-bcac-41a8-a59c-3e2432db6eaf",
	"type": "PIX_KEY",
	"amount": 804,
	"batchId": "bc4c72fd-a9b4-4952-ac8a-b60d8821be8b",
	"scheduledDate": "2026-03-02",
	"paymentDate": "2026-03-02",
	"status": "RETAINED",
	"debitParty": {
		"taxId": "3333210000131",
		"name": "TESTE",
		"number": "00444444",
		"branchCode": "50",
		"bankCode": "208"
	},
	"detail": {
		"key": {
			"type": "EMAIL",
			"value": "teste@gmail.com"
		},
		"endToEndId": "E40306294444602241521d01918e78b7",
		"creditParty": {
			"account": {
				"bankCode": "***",
				"branch": "****",
				"ispb": "********",
				"number": "********",
				"type": "**"
			},
			"name": "teste",
			"taxId": "***973328**"
		}
	},
	"authenticationCode": "e875761e1263eas2134125",
	"tags": {
		"externalId": "1234123443"
	},
	"errors": [
		{
			"arguments": {
				"x-auth-totp-biometry": "true",
				"x-operation-id": "699b9e08-ec8a-42cc-9ec0-a817952bac9a",
				"x-transaction-id": "99e40894170c3589c1945759df8abbdaa0318f95cbf6bd3fe3bae88c5082567a",
			},
			"code": "pending-fraud-task"
		}
	]
}

payments.invalidated

{
    "paymentId": "b96e54b3-da05-46e8-9845-99ec1e57339b",
    "type": "PIX_KEY",
    "amount": 350,
    "batchId": "437a4198-f14f-4bb6-b1e7-e1a68243bae9",
    "scheduledDate": "2025-04-07",
    "paymentDate": "2025-04-07",
    "status": "INVALIDATED",
    "debitParty": {
        "taxId": "33330336000333",
        "name": "FANTASY NAME",
        "number": "003333351",
        "branchCode": "50",
        "bankCode": "208"
    },
    "errors": [
        {
            "code": "reason for the error goes in here"
        }
    ],
    "detail": {
        "key": {
            "value": "50833333000333",
            "type": "TAX_ID"
        },
        "endToEndId": "E303333942023330719104edc4bd4444",
        "creditParty": {
            "account": {
                "taxId": "***588720001**",
                "name": "Nome"
            }
        }
    },
    "tags": {
        "externalId": "05f0333b-c539-4333-8bf3-dcb3a333ecb5"
    }
}

payments.adjourned

{
    "tags": {
        "externalId": "83406184-4115-4386-a90c-58b9727cec9f"
    },
    "type": "BANKSLIP",
    "amount": 1646.5,
    "detail": {
        "fine": 0,
        "payee": {
            "taxId": "1111111111",
            "bankCode": "208",
            "socialName": "NOME",
            "fantasyName": "NOME DE FANTASIA"
        },
        "barcode": "99999966300009999991090000051649999989343000",
        "dueDate": "2024-03-22",
        "discount": 0,
        "interest": 0,
        "bankSlipType": "BIT",
        "digitableLine": "99999966300009999991090000051649999989343000",
        "expirationDate": "2034-03-22"
    },
    "errors": [
        {
            "code": "insufficient-balance"
        }
    ],
    "status": "ADJOURNED",
    "paymentId": "e18d5387-87e2-4d7c-b604-b9f2956a6525",
    "debitParty": {
        "name": "Nome",
        "taxId": "11111111",
        "number": "1234567",
        "bankCode": "208",
        "branchCode": "50"
    },
    "paymentDate": "2024-03-22",
    "scheduledDate": "2024-03-22"
}

payments.failed

{
    "tags": {
        "externalId": "boleto234744"
    },
    "type": "BANKSLIP",
    "amount": 125,
    "detail": {
        "fine": 0,
        "payee": {
            "taxId": "11111111",
            "bankCode": "208",
            "socialName": "Nome",
            "fantasyName": "Nome de fantasia"
        },
        "barcode": "111111111111111111111111111111",
        "dueDate": "2024-03-18",
        "discount": 0,
        "interest": 0,
        "bankSlipType": "BIT",
        "digitableLine": "11111111111111111111111111111",
        "expirationDate": "2024-03-18"
    },
    "errors": [
        {
            "code": "operation-expired"
        }
    ],
    "status": "FAILED",
    "paymentId": "7b87f46c-4fe2-49b3-85f9-84c02cad051c",
    "debitParty": {
        "name": "Nome",
        "taxId": "111111111",
        "number": "11111111",
        "bankCode": "208",
        "branchCode": "50"
    },
    "paymentDate": "2024-03-13",
    "scheduledDate": "2024-03-13"
}

payments.canceled

{
    "tags": {},
    "type": "BANKSLIP",
    "amount": 95,
    "detail": {
        "payee": {
            "taxId": "11111111",
            "bankCode": "208",
            "socialName": "NOME",
            "fantasyName": "NOME DE FANTASIA"
        },
        "barcode": "1111111111111111111111111",
        "dueDate": "2024-02-10",
        "digitableLine": "11111111111111111111"
    },
    "category": "BANKSLIP",
    "paymentId": "a38c803b-ef9e-45a3-9251-be7dde4a30c4",
    "debitParty": {
        "name": "Nome",
        "taxId": "11111111111",
        "number": "1111111",
        "bankCode": "208",
        "branchCode": "50"
    },
    "scheduledDate": "2024-02-14"
}

payments.reverted

{
    "tags": {},
    "type": "TED",
    "amount": 128,
    "detail": {
        "creditParty": {
            "name": "NOME",
            "taxId": "1111111111",
            "account": {
                "ispb": "90400888",
                "type": "PP",
                "branch": "3561",
                "number": "0324134124",
                "bankCode": "033"
            }
        }
    },
    "errors": [
        {
            "code": "incorrect-receiver-data"
        }
    ],
    "status": "REVERTED",
    "paymentId": "8e454e0d-5b9e-425a-b7cd-e5ba9dc6a5db",
    "debitParty": {
        "name": "NOME",
        "taxId": "1111111111111",
        "number": "12412341234",
        "bankCode": "208",
        "branchCode": "50"
    },
  	"authenticationCode":"273b1930471263p1291273b",
    "paymentDate": "2024-03-11",
    "scheduledDate": "2024-03-11"
}

payments.processed

{
    "tags": {
        "externalId": "boleto211179"
    },
    "type": "BANKSLIP",
    "amount": 150,
    "detail": {
        "fine": 0,
        "payee": {
            "taxId": "11111111111",
            "bankCode": "341",
            "socialName": "nome",
            "fantasyName": "nome de fantasia"
        },
        "barcode": "111111111111111111",
        "dueDate": "2024-03-10",
        "discount": 0,
        "interest": 0,
        "bankSlipType": "BIT",
        "digitableLine": "111111111111111111",
        "expirationDate": "2024-06-08"
    },
    "status": "PROCESSED",
    "paymentId": "9529d0ce-6e03-40fa-9445-95f614133d60",
    "debitParty": {
        "name": "NOME",
        "taxId": "11111111111",
        "number": "1234123421",
        "bankCode": "208",
        "branchCode": "50"
    },
    "paymentDate": "2024-03-11",
    "scheduledDate": "2024-03-11"
}

payments.created

{
        "paymentId": "b2e2cfa6-2b39-45af-8865-30594748f496",
        "type": "PIX_KEY",
        "amount": 973,
        "scheduledDate": "2024-11-15",
        "paymentDate": "2024-11-15",
        "status": "CREATED",
        "debitParty": {
            "taxId": "11111111111",
            "name": "NOME",
            "number": "111111111",
            "branchCode": "50",
            "bankCode": "208"
        },
        "detail": {
            "key": {
                "value": "example-de-chave",
                "type": "TAX_ID"
            },
            "endToEndId": "E303061142111111118111e3b49d67b8",
            "creditParty": {
                "taxId": "11188136911",
                "name": "NOME CREDIT PARTY",
                "account": {
                    "type": "11",
                    "number": "123123123",
                    "branch": "50",
                    "bankCode": "208",
                    "ispb": "123123"
                }
            }
        },
        "tags": {
            "externalId": "2145265"
        }
}  

payments.scheduled

{
    "type": "BANKSLIP",
    "amount": 163.46,
    "detail": {
        "payee": {
            "taxId": "42383685000142",
            "bankCode": "41",
            "socialName": "NOME",
            "fantasyName": "NAO INFORMADO"
        },
        "barcode": "11111111111111111",
        "digitableLine": "11111111111111111111111111111111"
    },
    "batchId": null,
    "category": "BANKSLIP",
    "paymentId": "70c482c8-020a-4236-8831-a44fd5f010a5",
    "debitParty": {
        "name": "",
        "taxId": "12431241243214",
        "number": "123123123123",
        "bankCode": "208",
        "branchCode": "50"
    },
    "paymentDate": "2024-03-15T00:00:00",
    "scheduledDate": "2024-03-15T00:00:00"
}

payments.confirmed

{
    "tags": {
        "externalId": "boleto197054"
    },
    "type": "BANKSLIP",
    "amount": 3000,
    "detail": {
        "fine": 0,
        "payee": {
            "taxId": "132412341234",
            "bankCode": "341",
            "socialName": "nome",
            "fantasyName": "nome de fantasia"
        },
        "barcode": "12341234123412412421341242143",
        "dueDate": "2024-03-10",
        "discount": 0,
        "interest": 0,
        "bankSlipType": "BIT",
        "digitableLine": "11111111111111111111111111111",
        "expirationDate": "2024-06-08"
    },
  	"authenticationCode":"273b1930471263p1291273b",
    "status": "CONFIRMED",
    "paymentId": "bc09a2cd-990f-466d-83e5-e18806fc3470",
    "debitParty": {
        "name": "nome",
        "taxId": "23412431234",
        "number": "1243214214214",
        "bankCode": "208",
        "branchCode": "50"
    },
    "paymentDate": "2024-03-11",
    "scheduledDate": "2024-03-11"
}

payments.confirmed en el caso de PIX

{
    "paymentId": "999ed999-e2e3-999b-abdd-b6dc9999ef1d",
    "type": "PIX_KEY", //Pode assumir o valor de qualquer um dos tipos de PIX
    "amount": 1,
    "scheduledDate": "2024-06-04",
    "paymentDate": "2024-06-04",
    "status": "CONFIRMED",
    "debitParty": {
        "taxId": "9999995980990112",
        "name": "EXEMPLO",
        "number": "0099999941",
        "branchCode": "50",
        "bankCode": "208"
    },
    "detail": {
        "creditParty": {
            "taxId": "499999990009999",
            "name": "Criar Agencia",
            "account": {
                "type": "CC",
                "number": "39999919",
                "branch": "1",
                "bankCode": "999",
                "ispb": "99899899096"
            }
        },
        "key": {
            "type": "TAX_ID",
            "value": "9999995999915"
        },
        "endToEndId": "E9999999999041446999999d16d"
    },
  	"authenticationCode":"E9999999999041446999999d16d",
    "tags": {}
}

Códigos de error

A continuación se encuentran los errores posibles al realizar una solicitud a la API junto con sus descripciones. Todos los errores estarán prefijados en la respuesta con btg:enterprise:banking:payments

Error	Descripción
account-not-found	Cuenta no encontrada.
aegis-integration-error	Hubo un error durante la generación del contrato. Verifique su extracto antes de intentarlo nuevamente.
amount-above-limit	El monto del boleto está por encima del permitido. Por favor, realice el pago en otra institución financiera.
amount-below-limit	El monto del boleto está por debajo del permitido. Por favor, realice el pago en otra institución financiera.
amount-doesnt-match	El monto del pago no corresponde al monto informado.
balance-rejected	Saldo insuficiente.
bank-code-not-found	Código del banco no encontrado.
bankslip-canceled	El boleto ya no está disponible para pago. Es posible que ya haya sido pagado o cancelado por la institución que lo emitió.
batch-id-with-different-owner	Este pago no puede ser agregado al lote.
batch-not-found	Lote no encontrado.
blocked-account-status	No es posible operar una cuenta totalmente bloqueada.
business-day-validation-error	No fue posible validar si es día hábil.
cannot-adjourn-payment	No fue posible aplazar el pago.
cannot-cancel-payment	No fue posible cancelar la programación del pago.
cannot-confirm-payment	No fue posible realizar el pago.
cannot-confirm-without-authentication-code	No es posible confirmar el pago sin código de autenticación.
cannot-confirm-without-settlement-date	No es posible confirmar el pago sin fecha de liquidación.
cannot-fail-payment	No fue posible fallar el pago.
cannot-process-payment	No fue posible procesar la programación del pago.
cannot-revert-payment	No fue posible revertir el pago.
cannot-schedule-overdue-payment	El pago no puede ser programado después de la fecha de vencimiento.
cannot-schedule-payment	No fue posible programar el pago.
cannot-translate-confirm-event	Error al traducir el evento de confirmación de pago.
cash-grid-not-open	La grilla horaria no está abierta para esta operación.
cash-grid-validation-error	No fue posible validar la grilla de liquidación.
closing-account-status	No es posible operar una cuenta en proceso de cierre.
contract-expiration-overdue	Operación expirada, por favor rehaga el pago.
covenant-not-allowed	Este boleto solo puede ser pagado en instituciones afiliadas.
customer-service	Consulte con el servicio al cliente.
debit-party-different-from-original-movement	La cuenta de débito debe ser la misma del movimiento original.
duplicate-payment	Error al realizar el pago. Operación ya realizada o en curso.
empty-account	No fue posible realizar el pago. No encontramos la cuenta informada.
empty-bank-slip-type	Categoría del boleto no informada.
empty-credit-account	No fue posible realizar el pago. No encontramos la cuenta de crédito informada.
empty-credit-party	No fue posible realizar el pago. Datos del beneficiario no informados.
empty-party	No fue posible realizar el pago. Datos del pagador no informados.
emv-invalid	El Emv es inválido.
emv-required	El Emv es obligatorio.
error-adjourn-payment	Ocurrió un error al aplazar el pago.
error-cancel-payment	Ocurrió un error al cancelar el pago.
error-checking-activation-account	No fue posible verificar el estado de la cuenta.
error-confirm-payment	Ocurrió un error al confirmar el pago.
error-create-payment	Ocurrió un error al crear el pago.
error-create-payment-event	Ocurrió un error al crear el evento de pago.
error-decode-filters	Error al filtrar los pagos. Verifique los parámetros de filtro.
error-dispatch-payment	Ocurrió un error al realizar el pago.
error-fail-payment	Ocurrió un error al fallar el pago.
error-invalid-settlement-date	No fue posible crear la fecha de liquidación. Valor vacío.
error-retrieving-account	No fue posible obtener los datos de la cuenta.
error-retrieving-account-information	Error al realizar el pago. Intente nuevamente más tarde.
error-revert-payment	Ocurrió un error al revertir el pago.
error-validate-balance-account	Error al validar saldo para la operación.
escrow-account	No fue posible realizar el pago. La cuenta de garantía no permite esta operación.
expired-barcode-or-digitable-line	Boleto vencido.
expired-payment-date	Fecha de pago inválida.
expired-qr-code	Este código QR ya está expirado.
failed-to-parse-close-date	No fue posible calcular la fecha de cierre de la devolución del PIX.
forbidden	Operación no autorizada.
identifier-reused	Ocurrió un error interno. Intente nuevamente más tarde.
inactive-account	No fue posible realizar el pago. Cuenta inactiva o bloqueada.
inactive-account-status	No es posible operar una cuenta cerrada.
inactive-credit-account	No fue posible realizar el pago. Cuenta de crédito inactiva o bloqueada.
incorrect-receiver-data	Datos del beneficiario inválidos, verifique el CPF/CNPJ y los datos de la cuenta antes de intentarlo nuevamente.
institution-does-not-support-payment-type	La institución del beneficiario no acepta este tipo de pago.
insufficient-balance	Error al realizar el pago. Saldo insuficiente.
integration-error	Ocurrió un error interno. Intente nuevamente más tarde.
integration-timeout-error	Su pago está siendo procesado. Verifique el extracto y el área de pagos.
internal	Ocurrió un error interno. Intente nuevamente más tarde.
invalid-account	Cuenta bancaria inválida.
invalid-account-status	Error al realizar el pago. Datos de la cuenta inválidos. Contacte con atención al cliente a través de nuestro chat.
invalid-account-type	No fue posible realizar el pago. El tipo de cuenta de débito es inválido.
invalid-account-type-ii	Error al realizar el pago. Operación denegada porque la cuenta seleccionada no está habilitada. Contacte con atención al cliente a través de nuestro chat.
invalid-amount	Monto inválido.
invalid-amount-comparison	La suma de los valores de capital, intereses y multa difiere del monto total.
invalid-authentication-code	Código de autenticación inválido.
invalid-barcode-or-digitable-line	Código de barras o línea digitada es inválido.
invalid-base-payment	No fue posible realizar el pago. Este no es un pago base.
invalid-branch	Sucursal inválida.
invalid-business-day	Error al realizar el pago. Fecha de pago inválida.
invalid-business-day-date	Fecha de pago inválida. La fecha de pago válida más próxima es {{newDate}}.
invalid-credit-account	La cuenta de crédito es inválida para esta operación.
invalid-credit-account-type	No fue posible realizar el pago. El tipo de cuenta de crédito informado es inválido.
invalid-date-time	Fecha y hora inválidas.
invalid-ddi	DDI inválido.
invalid-description	Descripción inválida.
invalid-digitable-line	Línea digitada inválida.
invalid-dynamic-pix-qr-code-info-identifier	El location del código QR es inválido.
invalid-end-to-end-id	Ocurrió un error interno, intente nuevamente más tarde.
invalid-fgts-barcode	Código de barras inválido.
invalid-format-business-day-date	Fecha con formato inválido {{date}}.
invalid-ispb	ISPB inválido.
invalid-json-input	Entrada inválida. Debe estar en formato JSON.
invalid-json-schema-field-account-type	El campo {{fieldName}} es inválido. Tipo de cuenta no soportado.
invalid-json-schema-field-amount	El parámetro {{fieldName}} es inválido. Debe ser numérico y mayor que 0.
invalid-json-schema-field-bank-code	El campo {{fieldName}} es inválido. Debe ser numérico con tres dígitos.
invalid-json-schema-field-bank-slip-digitable-line	El campo {{fieldName}} es inválido. Debe ser numérico con 47 o 48 dígitos.
invalid-json-schema-field-barcode	El campo {{fieldName}} es inválido. Debe ser numérico con 44 dígitos.
invalid-json-schema-field-barcode-or-digitable-line	digitableLine o barcode son obligatorios.
invalid-json-schema-field-branch	El campo {{fieldName}} es inválido. Debe ser numérico con uno o más dígitos.
invalid-json-schema-field-date	El campo {{fieldName}} es inválido. La fecha debe estar en formato yyyy-mm-dd.
invalid-json-schema-field-date-time	El campo {{fieldName}} es inválido. La fecha y hora debe estar en el formato: YYYY-MM-DDThh:mm:ss.SSSZ.
invalid-json-schema-field-description	Descripción inválida. Debe tener un máximo de 140 caracteres, conteniendo solo letras, números y espacios.
invalid-json-schema-field-digitable-line	El campo {{fieldName}} es inválido. Debe ser numérico con 47 o 48 dígitos.
invalid-json-schema-field-emv	El campo {{fieldName}} es inválido. Debe estar en un formato emv válido.
invalid-json-schema-field-gte-number	El campo {{fieldName}} es inválido. Debe ser un valor numérico mayor o igual a {{fieldParam}}.
invalid-json-schema-field-id	El campo {{fieldName}} es inválido. Debe ser un identificador único universal (uuid).
invalid-json-schema-field-ispb	El campo {{fieldName}} es inválido. Debe ser numérico con ocho dígitos.
invalid-json-schema-field-lte-number	El campo {{fieldName}} es inválido. Debe ser un valor numérico menor o igual a {{fieldParam}}.
invalid-json-schema-field-name	El campo {{fieldName}} es inválido. Debe contener caracteres alfanuméricos, espacios, guiones y apóstrofes.
invalid-json-schema-field-number	El campo {{fieldName}} es inválido. Debe ser numérico.
invalid-json-schema-field-numeric	El campo {{fieldName}} es inválido. Debe ser numérico.
invalid-json-schema-field-payment-end-to-end-id	El campo {{fieldName}} es inválido. Debe comenzar con el prefijo E seguido del ISPB de la institución iniciadora seguido de fecha y hora en el formato YYYYMMDDhhmm y once caracteres alfanuméricos.
invalid-json-schema-field-pix-key-type	El campo {{fieldName}} es inválido. Tipo de clave Pix no soportado.
invalid-json-schema-field-pix-qr-code-type	El campo {{fieldName}} es inválido. Debe indicar el tipo de código QR, STATIC o DYNAMIC.
invalid-json-schema-field-reference-number	El campo {{fieldName}} es inválido. Debe ser numérico con ocho dígitos.
invalid-json-schema-field-required	El campo {{fieldName}} es obligatorio.
invalid-json-schema-field-reversal-end-to-end-id	El campo {{fieldName}} es inválido. Debe comenzar con el prefijo D30306294 seguido de fecha y hora en el formato YYYYMMDDhhmm y once caracteres alfanuméricos.
invalid-json-schema-field-tax-id	El campo {{fieldName}} es inválido. Debe ser numérico y tener 11 dígitos para CPF o 14 para CNPJ.
invalid-json-schema-field-treasury-revenue-code	El campo {{fieldName}} es inválido. Debe ser numérico con cuatro dígitos.
invalid-json-schema-field-type	El campo {{fieldName}} es inválido. Tipo de pago no soportado.
invalid-json-schema-field-utilities-digitable-line	El campo {{fieldName}} es inválido. Debe ser numérico y tener 48 caracteres.
invalid-json-schema-param-gte-number	El parámetro {{fieldName}} es inválido. Debe ser un valor numérico mayor o igual a {{fieldParam}}.
invalid-json-schema-param-lte-number	El parámetro {{fieldName}} es inválido. Debe ser un valor numérico menor o igual a {{fieldParam}}.
invalid-json-schema-param-numeric	El parámetro {{fieldName}} es inválido. Debe ser numérico.
invalid-json-schema-param-payment-end-to-end-id	El parámetro {{fieldName}} es inválido. Debe comenzar con el prefijo E30306294 seguido de fecha y hora en el formato YYYYMMDDhhmm y once caracteres alfanuméricos.
invalid-json-schema-param-required	El parámetro {{fieldName}} es obligatorio.
invalid-json-schema-param-tax-id	El parámetro {{fieldName}} es inválido. Debe ser numérico y tener 11 caracteres para CPF y 14 para CNPJ.
invalid-name	Nombre de cuenta inválido.
invalid-ownership	No fue posible realizar el pago. Los datos de la cuenta no identifican al titular informado.
invalid-parameter-required	El parámetro {{fieldName}} es obligatorio.
invalid-parties-comparison	No fue posible validar si el pagador y el beneficiario tienen la misma cuenta bancaria.
invalid-payload	Payload inválido.
invalid-payment-adjourning-status	No fue posible aplazar el pago
invalid-payment-amount-for-time-limit	No fue posible realizar el pago. Los pagos por encima de R$ {{maxAmount}} están permitidos hasta las {{closeTime}}h.
invalid-payment-canceling-status	No fue posible cancelar el pago.
invalid-payment-confirming-status	No fue posible confirmar el pago.
invalid-payment-date	Fecha de pago inválida.
invalid-payment-failing-status	No fue posible fallar el pago.
invalid-payment-id	Id del pago inválido.
invalid-payment-method	No es posible pagar este boleto usando este método de pago.
invalid-payment-paying-status	No fue posible realizar el pago.
invalid-payment-processing-statu	No fue posible procesar el pago.
invalid-payment-retaining-status	No fue posible retener el pago.
invalid-payment-reverting-status	No fue posible revertir el pago.
invalid-payment-scheduling-status	No fue posible programar el pago.
invalid-payment-status	Estado de pago inválido.
invalid-payment-time	El pago puede realizarse entre las {{openTime}} y las {{closeTime}}.
invalid-payment-time-limit	No fue posible realizar el pago. El horario permitido es entre las {{openTime}} y las {{closeTime}}.
invalid-payment-type	El tipo de pago es inválido. Los valores posibles son: [BANKSLIP, DARF, PIX_KEY, PIX_MANUAL, PIX_QR_CODE, PIX_REVERSAL, TED, TEF, UTILITIES][BANKSLIP, DARF, PIX_KEY, PIX_MANUAL, PIX_QR_CODE, PIX_REVERSAL, TED, TEF, UTILITIES].
invalid-person-type	Tipo de persona (física/jurídica) inválido.
invalid-phone	Teléfono inválido.
invalid-phone-format	Formato de teléfono inválido.
invalid-pix-branch	No fue posible realizar el pago. Sucursal inválida para pagos Pix.
invalid-pix-qr-code-info-identifier	El Emv, location o clave Pix y el id de la transacción son inválidos.
invalid-qr-code	Código QR rechazado por la institución financiera de destino.
invalid-remaining-amount	Error al consultar el monto restante del pago original.
invalid-reversal-amount	No fue posible realizar el pago. El monto de la devolución es mayor que el saldo restante del pago.
invalid-reversal-payment-date	No fue posible realizar el pago. La fecha de devolución para este Pix expiró.
invalid-static-pix-qr-code-info-identifier	La clave Pix o el transaction id son inválidos.
invalid-tag-key	Clave de la etiqueta inválida.
invalid-tag-value	Valor de la etiqueta inválido.
invalid-tags	Etiquetas inválidas.
invalid-tax-id	Debe ser un CPF/CNPJ válido.
invalid-time	Horario inválido.
invalid-time-interval	Intervalo inválido.
invalid-transaction-id	El identificador de la transacción del código QR es inválido.
invalid-transfer-type	Tipo de transferencia inválido.
ispb-not-found	ISPB no encontrado.
limit-rejected	Límite transaccional no disponible.
limit-validation-error	No fue posible validar los límites transaccionales.
linked-account	No fue posible realizar el pago. La cuenta vinculada no permite esta operación.
missing-identification-header	El header de identificación obligatorio no fue enviado.
missing-required-header	Los headers obligatorios no fueron enviados.
no-balance-account	Saldo insuficiente para la operación.
no-response-transactional-limit-service	Error al consultar el límite transaccional.
not-business-day	No es día hábil.
not-found-result	Pago no encontrado.
onboarding-validation-error	No fue posible validar el onboarding.
operation-canceled	Operación cancelada.
operation-expired	Pago no aprobado a tiempo, por favor rehaga la operación.
out-of-payment-hours	Error al realizar el pago. Fuera del horario permitido.
parent-already-closed	No es posible agregar pagos a un contrato que fue cerrado.
parser-response-error-transactional-limit-service	Error al consultar el límite transaccional.
partially-blocked-account-status	No es posible operar una cuenta parcialmente bloqueada.
parties-are-the-same	El pagador y el beneficiario tienen la misma cuenta bancaria.
past-payment-date	No es posible realizar pagos para fechas en el pasado.
payer-restricted	Pago no realizado. Verifique si la empresa tiene pendencias.
payer-restrictions	No fue posible realizar el pago. Verifique si la empresa tiene pendencias.
payment-already-adjourned	El pago ya está en proceso de reintento.
payment-already-canceled	El pago ya está cancelado.
payment-already-confirmed	El pago ya está confirmado.
payment-already-created	El pago ya está en proceso de pago.
payment-already-exists	El pago ya existe. Verifique su extracto antes de intentarlo nuevamente.
payment-already-processed	El pago ya está procesado.
payment-already-processing	El pago ya está en proceso de pago.
payment-already-reverted	El pago ya fue revertido.
payment-already-scheduled	El pago ya está programado.
payment-already-started	El pago ya está pendiente de aprobación.
payment-amount-changed	El monto del boleto cambió desde su emisión.
payment-date-after-expiration	No fue posible realizar el pago. La fecha del pago es posterior a la fecha de expiración.
payment-details-not-found	No fue posible encontrar los detalles del pago.
payment-expired	El pago expiró a las {{expirationDateTime}} y no pudo ser procesado.
payment-failed-by-credit-party	Hubo una falla en la recepción del pago en la institución financiera de destino.
payment-not-allowed	No fue posible realizar el pago. Verifique si ya está vencido, o si está dentro del horario permitido.
payment-not-authorized	Pago no autorizado.
payment-not-found	Pago no encontrado.
payment-timed-out	El pago fue interrumpido por el proveedor debido a un alto tiempo de espera de respuesta.
payment-type-not-supported	Tipo de pago {{paymentType}} no soportado.
pending-approval	Pendiente de aprobación de representante legal.
pending-ciba	Pendiente validación en otro dispositivo.
pending-fraud-task	Pendiente desafío.
pix-key-not-found	Clave Pix no encontrada.
pix-key-not-supported	Clave Pix inválida.
pix-key-type-not-supported	Tipo de clave Pix {{pixKeyType}} no soportado.
pix-qr-code-type-not-supported	Tipo de código QR {{pixQRCodeType}} no soportado.
pix-reversal-original-pix-not-found	El PIX original no fue encontrado.
quick-transfer-fetch-error	Consulte con el servicio al cliente.
reject-transactional-limit-amount-daily	Se superó el límite diario. Verifique sus límites.
reject-transactional-limit-default	Se superó el límite transaccional.
reject-transactional-limit-global-amount-daily	Se superó el valor límite permitido. Verifique sus límites.
reject-transactional-limit-global-number-daily-operations	Se superó la cantidad límite de operaciones diarias. Verifique sus límites.
reject-transactional-limit-number-daily-operations	Se superó la cantidad de operaciones diarias. Verifique sus límites.
required-pix-qr-code-credit-party	Los datos de la cuenta de crédito son obligatorios.
required-pix-qr-code-emv	El Emv es obligatorio.
required-pix-qr-code-end-to-end-id	EndToEndId es obligatorio.
required-pix-qr-code-pix-key	El id de transacción es obligatorio.
required-pix-qr-code-transaction-id	La clave Pix es obligatoria.
required-pix-qr-code-type	El tipo del Pix QR Code es obligatorio.
reserve-account	No fue posible realizar el pago. Cuenta de crédito inválida para cuenta BTG.
un-sanctioned-account	Cuenta sancionada por las Naciones Unidas.
unauthorized-user	Usuario no autorizado.
unavailable-accounts-table-service	Error al consultar la información de la cuenta.
unavailable-ispb-table	No fue posible obtener la información de ISPB.
unavailable-transactional-limit-service	Error al consultar el límite transaccional.
unmapped-error	Hubo un error durante la ejecución del pago. Verifique su extracto antes de intentarlo nuevamente.
unprocessable-barcode-or-digitable-line	Boleto no reconocido por la institución financiera.
unregistered-barcode-or-digitable-line	Este boleto aún no ha sido registrado. Intente nuevamente más tarde.
whitelist-validation	No fue posible validar la whitelist.
wrong-payment-type	Tipo de pago inválido.
invalid-payment-edition	El pago no puede ser editado.
invalid-payment-type-edition	El tipo del pago no puede ser editado.
invalid-payment-status-edition	Solo los pagos pendientes de aprobación y sin ninguna firma pueden ser editados.
invalid-payment-system-origin-edition	Los pagos realizados por planilla o cnab aún no pueden ser editados.
invalid-payment-amount-edition	El monto del pago no puede ser editado.
invalid-payment-system-origin-edition	Los pagos realizados por planilla o cnab aún no pueden ser editados.
invalid-payment-amount-edition	El monto del pago no puede ser editado.
invalid-payment-credit-party-edition	Los datos del beneficiario no pueden ser editados.
payment-no-changes-edition	Ninguna información del pago fue modificada.
contract-not-found	Pago no encontrado.
contract-partially-signed	El pago ya contiene firmas y no puede ser editado.
invalid-report-status	Estado de disputa de pago inválido.
invalid-report-type	Tipo de disputa de pago inválido.
invalid-reason-type	Motivo de disputa de pago inválido.
invalid-system-origin	Origen del sistema inválido.
invalid-payment-type-for-infraction	La disputa no está disponible para este tipo de pago.
invalid-infraction-period	Pago realizado hace más de {{maxDaysInfraction}} días.
infraction-already-created	El pago ya fue disputado y está en análisis por la institución de destino.
report-not-found	Disputa de pago no encontrada.
btg:enterprise:contract:create:error:status	Verifique con el servicio al cliente sus poderes y rehaga esta operación.